Release 10.1A: OpenEdge Development:
ADM Reference

clientSendRows

Calls across the AppServer boundary to serverSendRows to fetch a batch of RowObject temp-table records. When the SmartDataObject (SDO) is divided between the client and AppServer, this client-side procedure runs from the generic sendRows procedure and then runs a server-side version that returns the RowObject temp-table records.

Location: data.p

Parameters:

INPUT piStartRow AS INTEGER

The RowNum value of the record to start the batch to return. Typically piStartRow is ? as a flag to use pcRowIdent instead of piStartRow.

INPUT pcRowIdent AS CHARACTER

The RowIdent of the first record of the batch to return. Can also be FIRST or LAST to force the retrieval of the first (or last) batch of RowObject records.

INPUT plNext AS LOGICAL

TRUE if serverSendRows is to start on the next record from what is indicated by piStartRow or piRowIdent.

INPUT piRowsToReturn AS INTEGER

The number of rows in a batch.

OUTPUT piRowsReturned AS INTEGER

The actual number of rows returned. This number is either the same as piRowsToReturn or less when there are not enough records to fill up the batch.

Notes:

All of the parameters are simply received from the caller and passed through to serverSendRows on the AppServer.
If piStartRow is not 0 or ? then pcRowIdent is ignored.
plNext is ignored if pcRowIdent is FIRST or LAST.
The most common use of piRowsReturned is to indicate that the entire result list has been returned when it is less than piRowToReturn.